@WojciechNagorski Ready for review and merge. Let me know if you have any questions!

@WojciechNagorski @Rob-Hague This is now ready to merge and synced with develop.

Thanks @jscarle. I don't know anything about it but it looks nice and simple. Two questions:

1. Is it possible to preview the output without merging, either locally or on GH?

Certainly! From the root of the repository, simply run the two commands from the pipeline:

dotnet tool update -g docfx
docfx ./docfx/docfx.json

That will produce the site in ./docfx/_site, which as you'll see, is just a plain HTML site. You can view it by opening index.html.

2. Is it possible to have the additional docs (features.md, foreward.md, usage.md) without duplicating from the README? E.g. including snippets of markdown (or something). If not, can we just directly use the README for now to avoid having to update in multiple places?

Sure, we can do whatever we'd like with the additional content of the site. I just split up the README as a starting point. I could also work into a way to include the README directly. Though the objective would be to simplify the README and instead grow this site.

On index.html I don't see anything to click on to get to the code. Does that get hooked up automatically?

For the additional content, I'll leave it up to you if you expect the site and the readme to diverge in the near future. If they are going to stay equal for a while, then having just one place to update would be nicer from a maintenance perspective if it's easy to do.

On index.html I don't see anything to click on to get to the code. Does that get hooked up automatically?

Sorry about that, I forgot. You have to do:

docfx ./docfx/docfx.json --serve

Then, at the end you should see:

Serving "E:\github\SSH.NET\docfx\_site" on http://localhost:8080. Press Ctrl+C to shut down.

It runs a little bit of JavaScript, so that's probably why it won't completely load locally without running serve.

http://sshnet.github.io/SSH.NET/

Good stuff!

Need to update https://github.com/sshnet/SSH.NET/blob/develop/docfx/docs/foreword.md/